<html>

<div align="center"><h2>Guida j-ff</h2></div>

<h3>Indice</h3>
<ul>
<li><a href="#intro"><b>Introduzione</b></a></li>
<li><a href="#terminology"><b>Glossario</b></a></li>
<li><a href="#addfiles"><b>Aggiungere Files Video </b></a></li>
<li><a href="#setoptions"><b>Impostare le Opzioni di Conversione</b></a></li>
<li><a href="#createtask"><b>Creare un Processo</b></a></li>
<li><a href="#starttasks"><b>Iniziare i Processi</b></a></li>
<li><a href="#issues"><b>Problemi comuni</b></a></li>
</ul>

<a name="intro"></a>
<h3>Introduzione:</h3>
Con j-ff avrai la possibilita' di convertire i tuoi files video nel modo piu' semplice possibile:
<ul>
<li>prima selezioni i files</li>
<li>poi selezioni la cartella di destinazione e le impostazioni(predefinite per i dispositivi piu' comuni)</li>
<li>infine inizi la conversione e lasci che sia il programma a gestire tutto il lavoro!</li>
</ul>
In questa guida si spiega il comune metodo di utilizzo di j-ff e si provvede a fornire una soluzione ai problemi comuni riscontrati.

<a name="terminology"></a>
<h3>Glossario:</h3>
<ul>
<li><b>File Video</b>: un file video che devi convertire in un altro formato</li>
<li><b>Processo</b>: un lavoro organizzato per il programma che consiste in un gruppo di Files Videoche devono essere convertiti con delle opzioni definite</li>
<li><b>Conversione</b>:Sinonimo di Processo</li>
<li><b>Opzioni</b>:il set di opzioni disponibili per il processo. Consiste di
<ul>
<li>una cartella di destinazione</li>
<li>un formato di output</li>
<li>un set di opzioni hardware, come ad esempio il numero di CPU che vuoi utilizzare</li>
<li>un set di opzioni di conversione, come ad esempio <i>aggiungi pads</i> o <i>doppia passata</i></li>
</ul></li>

</ul>

<a name="addfiles"></a>
<h3>Aggiungere Files Video</h3>
You can add your video files either with the first button of the toolbar or the menu voice File>AddFile.
Open the files from the filechooser (multiple selection is allowed) and they will appear in the upper table.
The upper table (aka the Video Files Table) show the opened files and display the most important parameters such as
<i>duration, dimensions, pixel aspect ratio and display aspect ratio</i>. That should present different cases:
<ul>
<li>If all this data will be showed correctly it means
that the file you have opened is a perfect candidate for conversion</li>
<li>If pixel aspect ratio and display aspect ratio (PAR and DAR) are "???" then the converted file should present
problem on the final aspect ratio</li>
<li>If all the data are "???" it should be that:
<ul>
<li>or the Video File is in an unknown format and it probably will results unconvertible</li>
<li>or ffmpeg hasn't been found. See Common issues about that</li>
</ul></li>
</ul>

<h4>Tips:</h4>
<ul>
<li>To delete a Video File from the Video Files Table yust select it and press the second button of the toolbar or the menu voice File>Delete File.
This wont affect the real file on your Hard Disk.</li>
<li>The Select voice on the menu bar will help you make your selections faster.</li>
<li>The third button on the toolbar will play the evidentiated Video File with the default System player</li> 
<li>You can show and hide the Video Files Table anytime using the menu voices File>show/hide files. This is useful to have more space to display the other elements</li>
</ul>
<a name="setoptions"></a>
<h3>Impostare le Opzioni di Conversione</h3>
Once you have done a good selection of Video Files in the Video Files Table, you have to set the Conversion options.
In the middle of the frame there is a tabbed panel (the Option tabbed pane) that give you the possibility to do so.
You can set:
<ul>
<li>first panel: the folder in which your converted files will be saved</li>
<li>second panel: the output format from a list of predefined formats</li>
<li>third panel: the number of threads every single file will create to be converted (it should be equal to your CPU number)</li>
<li>fourth panel:<ul>
<li>two passes option: it takes more time but it will do a much accurate conversion with a double pass mode</li>
<li>pads option: add pads to the final video to preserve the output format aspect ratio</li>
<li>small files option: if the output format dimension is too big it will avoid to do a file bigger than the original, changing only the aspect ratio to fit the output format</li>
<li>debug option: if the conversion fails you can have a look at the ffmpeg output in a txt file created in the same folder as the output file</li>
</ul>
</li>
</ul>
<h4>Tips:</h4>
<ul>
<li>As the Video Files Table you can show and hide the Options Tabbed Panel anytime using the menu voices Options>show/hide options. This is useful to have more space to display the other elements</li>
</ul>

<a name="createtask"></a>
<h3>Creare un Processo</h3>
Once you have set the Options it's time to create the Task: simply press the corresponding button on the toolbar or the menu Tasks>Create Task.
Now the selected files will disappear from the Video Files Table and in the latter part of the frame the Task Table will show your yust-created Task.
this task will have the name of the output folder and clicking on it you will see all the involved Video File names.
The progress column will show the progress percent of the total conversion in the row of the Task name and the single file progress percent in the row of the corresponding file name
<h4>Tips:</h4>
<ul>
<li>Never create a Task with the output folder equal to the folder where the input Video Files are. It should permanently corrupt your files! </li>
<li>The output folder should be choosen with caution: files with the same name as the output files will be overwritten permanently!</li>
<li>You can delete a Task or all Tasks with the corresponding buttons on the toolbar or the menu voices in Task>Delete Task/Delete All Tasks (Only if they aren't running)</li>
</ul>

<a name="starttasks"></a>
<h3>Iniziare i Processi</h3>
If you have uncompleted tasks in the Tasks Table you can start them simply clicking on the play button on the toolbar or in the menu Task>Play Tasks.
Now the Task Table will show the progress of the Conversions: when they arrive at 100% your files are ready!   
<h4>Tips:</h4>
<ul>
<li>You can interrupt your Tasks anytime pressing the pause task button(or Tasks>Pause Tasks) or simply closing the application. It will cause no problem at all!</li>
</ul>

<a name="issues"></a>
<h3>Problemi comuni</h3>
<h4>Q: Tutti i miei Files Video ottengono solo "???" nella tabella dei Files Video e non riesco a convertirli</h4>
A: Hai dei problemi con ffmpeg:
<ul>
<li>In Windows devi scaricare l'ultima "static build" di ffmpeg e copiare il file ffmpeg.exe nella cartella j-ff.
<li>In Linux devi installare il pacchetto ffmpeg >8.6.2. 
</ul>

<h4>Q: Tutti i miei files di output occupano 0b e i Processi terminano immediatamente</h4>
A1: vedi la risposta alla domanda precedente<br />
A2: la Conversione ha avuto problemi; attivando l'opzione di debug puoi vedere cosa e' successo. Ffmpeg non supporta ogni tipo di files
quindi cose del genere possono accadere per particolari formati in input e in output 

<h4>Q: I miei Processi vengono eseguiti ma la Tabella dei Processi non mostra in modo corretto lo stato di avanzamento</h4>
A: Hai installato una vecchia versione di ffmpeg; questa applicazione e' compatibile solo con versioni di ffmpeg >8.6.2

<h4>Q: Perche' a volte i sottotitoli scompaiono nei file di output?</h4>
A: Ffmpeg ha i sui limiti, i sottotitoli separati nei propri stream di solito non vengono convertiti. I video "Hardsubbed" non avranno invece nessun problema    

<h4>Q: Questo programma interagisce con la mia connessione internet?? WTF!</h4>
A: Non stiamo facendo nulla di male. Questo programma usa la classe "java.net.ServerSocket" per controllare all'avvio che esista solo una singola istanza dell'applicazione.
Per maggiori informazioni controllare il codice in src/jff/main/jffgui.java<br />
<br />
<i>Nella speranza che questo programma Ti sia utile e Ti faccia risparmiare del tempo!</i> F.F.

</html>